home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-11 / butt01.zip / BUTTON.DOC < prev    next >
Text File  |  1993-01-04  |  10KB  |  318 lines
  1. k
  2.                        Archive Name : BUTT01.ZIP
  3.                    FoxCode Template : Button.Gen
  4.                            Language : FoxBase 2.1 & FoxPro
  5.                            Doc File : Button.Doc 
  6.  
  7.  
  8.                            ------------------
  9.                            Archive Files List
  10.                            ------------------
  11.  
  12.  
  13.  
  14.      BUTT01.ZIP - Preliminary Documentation for Button Menus
  15.  
  16. *****************************************************************
  17.                  Button Menu  Version 1 - 4/03/90 
  18. *****************************************************************
  19.  
  20.  
  21.               -=<  Button Menu Features  >=-
  22.  
  23.                   FoxView Designed Windows
  24.                   FoxBase + 2.01 Output Code
  25.                   FoxPro Output Code
  26.                   Mouse Support in FoxPro
  27.                   Help Windows
  28.                   Radio Buttons
  29.                   Check Boxes
  30.                   Text Buttons
  31.                   Hot Keys
  32.                   xBase Code Inserted
  33.                 * Scrollable List
  34.                 * GET Fields
  35.  
  36.      *NOTE:  These items are not supported in Version 1
  37.  
  38.  
  39.  
  40. =================================================================
  41. INTRODUCTION :
  42. ==============
  43.  
  44. This  template is designed to allow the user to create a  control 
  45. panel in FoxView  and then generate a menu with "Radio  Buttons", 
  46. "Check Boxes" and "Text Buttons".
  47.  
  48.  
  49. If  you  find  this  template useful and  convenient  to  use,  a 
  50. registration  of  $20 would be appreciated.  If you send  $30  or 
  51. more  you will receive, when available, the next version  of  the 
  52. BUTTON Menu Template. Please state the archive version number  of 
  53. the software that you currently have.  Send check or money  order  
  54. to:   
  55.  
  56.  
  57.  
  58.                      M I S  Consulting 
  59.                    2003 South 51st Street
  60.                      Tampa, Fl.   33619
  61.  
  62.  
  63. Send comments to Charles Alan Butler via Compuserve. (72251,633)
  64.  
  65.  
  66.  
  67.  
  68. =================================================================
  69. DEFINITIONS :
  70. =============
  71.  
  72. "Radio Buttons" are groups of choices where only one of the group 
  73. is  chosen.  The screen symbol is "( )" for a "Radio Button"  and 
  74. "(*)"  when it is selected.  Selecting another in the group  will 
  75. move the marker, clearing the previous mark.  The screen designer 
  76. must  place the "( )" as the first three characters of  the  text
  77. object.   You  will want to pad  out the right side of  the  text 
  78. object  so  that all within a group are of the same  length.  See 
  79. "Flags" for  more information.
  80.  
  81. "Check Box" is a single choice that is set ON or OFF.  The screen 
  82. symbol for this is "[ ]" and "[X]" when it is set ON. The  screen 
  83. designer  must place the "[ ]" as the first three  characters  of 
  84. the  text object.   Normally there  is no  sub  menu   associated 
  85. with  "Check Boxes", but they are supported with  this  template.  
  86. See "Flags" for more information.
  87.  
  88. "Text  Buttons"  are menu choices that initiate  action  of  some 
  89. type.  The  most common are <<OK>> and <Cancel>.  <<OK>>  may  be 
  90. selected  any  time  by pressing  Ctrl-Enter.   <Cancel>  may  be 
  91. selected  at any time by pressing Escape.  See "Flags"  for  more 
  92. information.
  93.  
  94.  
  95. =================================================================
  96. MOUSE :
  97. =======
  98.  
  99. The mouse is supported in FoxPro.  The upper  left corner of  the 
  100. box is the Escape Icon.  The bottom row is the Help Trigger.  All 
  101. menu pads when clicked on act as though the highlight was on  and 
  102. Enter was pressed.
  103.  
  104.  
  105.  
  106. =================================================================
  107. KEYBOARD :
  108. ==========
  109.  
  110. Key strokes that are supported are as follows:
  111.  
  112.             Key                      Action
  113.  
  114.           Enter               Select highlighted menu item
  115.           Space               Select highlighted menu item
  116.           Ctrl-Enter          Exit control panel
  117.           Ctrl-End            Exit control panel
  118.           Esc                 Exit control panel
  119.           F1 or H             Pop up Help window
  120.           Up/Down             Move Highlight one item
  121.           Tab/Shift Tab       Move Highlight one group
  122.           Home                Move Highlight to first item
  123.           End                 Move Highlight to last item
  124.  
  125.  
  126. =================================================================
  127. HOT KEYS :
  128. ===========
  129.  
  130. Hot Keys may be used in any "Radio Button", "Check Box" or  "Text 
  131. Button" by including in the FoxView text object the characters \<
  132. before the "Hot Key".  The color of the "Hot Key" must be entered 
  133. as the second parameter in the user field.  It is entered without 
  134. quotes.  The template does not test this entry for correctness.
  135.  
  136.  
  137. =================================================================
  138. USER AREA :
  139. ===========
  140.  
  141. The  User  Area  of the  control panel  box must  have  the letter
  142. "W" in it and may be followed with the color of the highlight bar.
  143. If the color is not included, the FIELD color is used.   M;w+/n
  144.  
  145. The  User Area in  FoxView is used to  inform the template  which 
  146. text objects are menu choices.  The Flags are as follows:
  147.  
  148. <Type Flag>;<Hot Key Color>;[<Default Value>;]<Action when tagged 
  149. True>
  150.  
  151. The <Default Value> is only used for 'B' and 'C' Flags.
  152.  
  153.      ---- Flag --------------------- Meaning --------------
  154.           B1;;                 Group 1 Radio Button
  155.           B1;;T;               Set to true upon entry
  156.           C;;                  Check Box item
  157.           C;;T;                Set to ON upon entry
  158.           C;;                  Set to OFF upon entry
  159.           OK;;                 Text Button for normal exit
  160.           ESC;;                Text Button for abort exit
  161.           M;;                  Text Button for menu action
  162.  
  163.  
  164. =================================================================
  165. xBASE CODE    :
  166. ===============
  167.           These Feature Are Not Supported in Version 1.0
  168.  
  169.  
  170. You may enter xBase code after the semi-colon which will be added 
  171. to  the  process  of the menu item. "Radio  Buttons"  and  "Check 
  172. Boxes" reserve  the  first three parameters for Flags and add the   
  173. remaining  parameters to the program as xBase Code. 
  174.               B1;;;Do SubMenu  or  B1;;T;Do SubMenu
  175.  
  176. "Text Buttons" use the first and second parameters as a Flag.
  177.            ESC;;AbortFlag =.T.  or  M;;Do SubMenu;Exit
  178.  
  179. You  may have up to 12 xBase code lines as long as they will  fit 
  180. in the  USER AREA.
  181.  
  182. *NOTE:   All USER AREA entries should be entered  without  quotes 
  183.          and separated with a semi-colon.
  184.  
  185.  
  186. =================================================================
  187. COLOR :
  188. =======
  189.  
  190. The "User Area" of the first box object is  where  the  highlight 
  191. color  is looked for.  If not found the "Field" color of the  box 
  192. object is used.   See "USER AREA".
  193.  
  194. The  color  set in FoxView for each  text object is used  by  the 
  195. generated program.  In FoxView use  Ctrl-P to set the color.
  196.  
  197. If "Hot Keys" are defined the color must be placed in the  second 
  198. parameter of the "USER FIELD".
  199.  
  200. Groups of items, "Radio Buttons" especially, should be  separated 
  201. on  the screen physically or by different colors so that the  end 
  202. user may clearly identify these groups.
  203.  
  204.  
  205.  
  206. =================================================================
  207. VARIABLES :
  208. ===========
  209.  
  210. Two  variables  are used as PUBLIC and they are "Ky"  and  "T_F". 
  211. "Ky"  is numeric and and is the ASCII value of the exit key.   It 
  212. will  be  10  if the user wishes to proceed or  27  if  the  user 
  213. aborted.   The  exit key may also be tested in FoxPro  using  the 
  214. LASTKEY(  ) function.  "T_F" is a logical array representing  the 
  215. condition  of  the  "Radio  Buttons",  "Check  Boxes"  and  "Text 
  216. Buttons" upon exit from the Control Panel.
  217.                                                                   
  218. Because this array is made public you must release it unless  you 
  219. want  to preserve the conditions and re-call the  Control  Panel.  
  220. If  you use a second Control Panel as a sub menu you must  change 
  221. the name of this array in the second Control Panel.
  222.  
  223. All other variables are used as PRIVATE.
  224.  
  225.  
  226. =================================================================
  227. ENVIRONMENT :
  228. =============
  229.  
  230. The screen is saved and restored  as well as FoxBase.  The colors
  231. are restored in both FoxBase and FoxPro.                          
  232.  
  233.  
  234. =================================================================
  235. FEED BACK :
  236. ===========
  237.  
  238. If  you have any suggestions for improving this template  or  any 
  239. comment at all, please contact me via  Compuserve 72251,633.  Any 
  240. comments are welcome.
  241.  
  242.  
  243. =================================================================
  244. Liability:
  245. ==========
  246.  
  247. MIS  Consulting  makes  no  representations  or  warranties  with 
  248. respect to the merchantability or fitness of this program for any 
  249. particular  purpose.  In no event shall MIS Consulting be  liable 
  250. for  any loss of profit or any commercial damage,  including  but 
  251. not  limited  to  special,  incidental,  consequential  or  other 
  252. damages.  Further,  MIS Consulting reserves the right  to  revise 
  253. this program and documentation at any time without obligation  to 
  254. notify any person or organization of such revision.
  255.  
  256.  
  257.  
  258. =================================================================
  259. Shareware:
  260. ==========
  261.  
  262. This product is Shareware.  You may try out the utility to see if 
  263. it is useful for you.  If it does increase your productivity, you 
  264. should send your registration to MIS Consulting for your licensed 
  265. agreement.  This   utility  may  not   be  distributed   in   its  
  266. source  code   form.  The  utility  may   be  distributed   in  a 
  267. compiled form, provided a distribution  license is  obtained.  
  268.  
  269.  
  270.  
  271. ****************************************************************
  272. ***  FoxBase is a trademark of Fox Software, Inc.            ***
  273. ***  FoxBase 2.1 is a Copyright of Fox Software, Inc.        ***
  274. ***  WordStar is a trademark of MicroPro International Corp  ***
  275. ****************************************************************
  276.  
  277. End Button.Doc
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317. 
  318.